Support MDX docs from manifests by JReinhold · Pull Request #120 · storybookjs/mcp

JReinhold · 2026-01-05T15:28:12Z

Companion PR in core: storybookjs/storybook#33408

This PR adds support for the new docs entries in manifests, that addon-docs now adds based on MDX files. It's not required, so it will still support Storybooks that don't use addon-docs.

See the following tests for how this is outputted to the LLM:

Breaking Changes

This PR introduces a number of minor breaking changes to @storybook/mcp:

The lower level tool adder functions have been renamed:
1. addGetComponentDocumentationTool -> addGetDocumentationTool
2. addListAllComponentsTool -> addListAllDocumentationTool
The optional tool hooks have been renamed:
1. onListAllComponents -> onListAllDocumentation
2. onGetComponentDocumentation -> onGetDocumentation
The exported MANIFEST_PATH constant have been removed in favor of two new constants, COMPONENT_MANIFEST_PATH and DOCS_MANIFEST_PATH

changeset-bot · 2026-01-05T15:28:17Z

🦋 Changeset detected

Latest commit: 861b5a4

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

💥 An error occurred when fetching the changed packages and changesets in this PR

Some errors occurred when validating the changesets config:
The package or glob expression "@storybook/mcp-eval*" is specified in the `ignore` option but it is not found in the project. You may have misspelled the package name or provided an invalid glob expression. Note that glob expressions must be defined according to https://www.npmjs.com/package/micromatch.

…t-docs-manifest-entries

pkg-pr-new · 2026-01-05T15:31:31Z

npm i https://pkg.pr.new/storybookjs/mcp/@storybook/addon-mcp@120

npm i https://pkg.pr.new/storybookjs/mcp/@storybook/mcp@120

commit: 861b5a4

codecov · 2026-01-05T15:31:48Z

Codecov Report

❌ Patch coverage is 92.78351% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 88.70%. Comparing base (7b85cb0) to head (861b5a4).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
packages/mcp/src/utils/get-manifest.ts	85.00%	0 Missing and 3 partials ⚠️
packages/addon-mcp/src/mcp-handler.ts	66.66%	1 Missing ⚠️
packages/addon-mcp/src/preset.ts	0.00%	0 Missing and 1 partial ⚠️
...kages/mcp/src/utils/manifest-formatter/markdown.ts	88.88%	0 Missing and 1 partial ⚠️
packages/mcp/src/utils/manifest-formatter/xml.ts	91.66%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #120      +/-   ##
==========================================
+ Coverage   87.82%   88.70%   +0.88%     
==========================================
  Files          19       21       +2     
  Lines         427      478      +51     
  Branches      122      134      +12     
==========================================
+ Hits          375      424      +49     
- Misses          8        9       +1     
- Partials       44       45       +1

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copilot

Pull request overview

This PR adds support for MDX-based documentation entries in component manifests, allowing Storybook's addon-docs to provide standalone and component-attached documentation via the MCP protocol. The changes include breaking renames of tool functions and handlers to reflect the broader scope beyond just components.

Key changes:

Adds DocsManifestMap type and parallel fetching of both component and docs manifests
Renames tools from list-all-components/get-component-documentation to list-all-documentation/get-documentation
Implements extractDocsSummary utility to parse MDX content for list previews
Updates all formatters (XML/Markdown) to support docs entries

Reviewed changes

Copilot reviewed 49 out of 50 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
pnpm-workspace.yaml, pnpm-lock.yaml	Updates Storybook dependencies to 10.2.0-alpha.10 to support new manifest features
packages/mcp/src/types.ts	Adds `Doc`, `DocsManifestMap`, `AllManifests` types; renames handlers from `onListAllComponents`/`onGetComponentDocumentation` to `onListAllDocumentation`/`onGetDocumentation`
packages/mcp/src/utils/get-manifest.ts	Refactors `getManifest` → `getManifests` to fetch both component and docs manifests in parallel; splits `MANIFEST_PATH` into `COMPONENT_MANIFEST_PATH` and `DOCS_MANIFEST_PATH`
packages/mcp/src/utils/manifest-formatter/*.ts	Adds `formatDocsManifest` and `extractDocsSummary`; renames `formatComponentManifestMapToList` → `formatManifestsToLists` to handle both manifest types
packages/mcp/src/tools/*.ts	Renames `list-all-components` → `list-all-documentation` and `get-component-documentation` → `get-documentation`; updates to handle both component and docs entries
packages/mcp/src/index.ts	Updates exports to reflect renamed functions and constants
packages/mcp/fixtures/small-docs-manifest.fixture.json	Adds test fixture for docs manifest
packages/mcp/bin.ts	Updates CLI args from `--manifestPath` to `--componentManifestPath` and adds `--docsManifestPath`
packages/addon-mcp/src/*.ts	Updates addon to use renamed tools/handlers and check for `experimental_manifests` preset instead of `experimental_componentManifestGenerator`
packages/addon-mcp/src/template.html	Updates tool name in UI template
apps/internal-storybook/stories/*.mdx	Adds example MDX documentation files for testing
apps/internal-storybook/tests/*.test.ts	Updates E2E tests with new tool names and adds docs manifest validation
eval/*, README.md, .github/instructions/.md	Updates documentation and configuration to reflect breaking changes
.changeset/*.md	Documents breaking changes for both packages

Files not reviewed (1)

pnpm-lock.yaml: Language not supported

JReinhold · 2026-01-05T15:38:33Z

The diff is "wrong" here, this is not a new file, but just the get-component-documentation renamed and changed.

JReinhold · 2026-01-05T15:41:45Z

+		return dedent`# ${doc.title}
+
+			${doc.content}`;
+	},


The first line here might be unnecessary/redundant, adding the title? We could also just assume that MDX files always has a # title?

Copilot

Pull request overview

Copilot reviewed 50 out of 51 changed files in this pull request and generated no new comments.

Files not reviewed (1)

pnpm-lock.yaml: Language not supported

Copilot

Pull request overview

Copilot reviewed 50 out of 51 changed files in this pull request and generated no new comments.

Files not reviewed (1)

pnpm-lock.yaml: Language not supported

valentinpalkovic

LGTM. Left some small comments. Please clean up the pnpm-lock.yaml file. (Remove the experiments)

…n/docs.json instead of supporting custom filenames

codecov · 2026-01-08T13:39:12Z

Bundle Report

Changes will increase total bundle size by 6.68kB (14.05%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name	Size	Change
@storybook/mcp-esm	32.63kB	6.62kB (25.47%) ⬆️⚠️
@storybook/addon-mcp-esm*	21.57kB	52 bytes (0.24%) ⬆️

ℹ️ *Bundle size includes cached data from a previous commit

Affected Assets, Files, and Routes:

view changes for bundle: @storybook/mcp-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`index.js`	3.63kB	22.11kB	19.67% ⚠️
`index.d.ts`	2.99kB	10.52kB	39.71% ⚠️

view changes for bundle: @storybook/addon-mcp-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`preset.js`	52 bytes	21.57kB	0.24%

Files in preset.js:

./src/tools/is-manifest-available.ts → Total Size: 472 bytes
./src/template.html → Total Size: 5.0kB
./src/preset.ts → Total Size: 1.76kB
./src/mcp-handler.ts → Total Size: 3.86kB

JReinhold added 10 commits December 30, 2025 09:30

make getManifest handle both component and docs manifests

85a71ec

add support for docs manifest in both tools

b577091

update bin and eval to support manifest split

b62ba38

fix manifest feature detection

65870cd

add MDX files to test support

57643f5

Use canary version of storybookjs/storybook#33408

fc7c0a2

fix tests

4c052cd

rename "list all components" tool to "list all documentation"

c54ad45

fix check-deps e2e tests

dee8b9d

remove dependency on canary again

5881e24

JReinhold added 2 commits January 5, 2026 16:29

add changesets

28ee9e1

Merge branch 'main' of https://github.com/storybookjs/mcp into suppor…

7d23317

…t-docs-manifest-entries

JReinhold marked this pull request as ready for review January 5, 2026 15:32

Copilot AI review requested due to automatic review settings January 5, 2026 15:32

JReinhold self-assigned this Jan 5, 2026

Copilot started reviewing on behalf of JReinhold January 5, 2026 15:32 View session

Copilot AI reviewed Jan 5, 2026

View reviewed changes

fix Button.mdx to match implementation

f999cae

JReinhold commented Jan 5, 2026

View reviewed changes

fix lints

a9b47ee

Copilot AI review requested due to automatic review settings January 5, 2026 15:46

Copilot started reviewing on behalf of JReinhold January 5, 2026 15:46 View session

Copilot AI reviewed Jan 5, 2026

View reviewed changes

JReinhold commented Jan 5, 2026

View reviewed changes

Comment thread eval/lib/collect-args.ts Outdated

JReinhold mentioned this pull request Jan 6, 2026

Upgrade SB to latest #115

Closed

add support for summary in MDX

4373b10

update storybook deps

38d21e1

Copilot AI review requested due to automatic review settings January 6, 2026 16:09

Copilot started reviewing on behalf of JReinhold January 6, 2026 16:09 View session

Copilot AI reviewed Jan 6, 2026

View reviewed changes

valentinpalkovic approved these changes Jan 7, 2026

View reviewed changes

Comment thread .changeset/large-carrots-judge.md

Comment thread .changeset/stale-ducks-pay.md

Comment thread eval/lib/collect-args.ts Outdated

Comment thread packages/addon-mcp/README.md Outdated

JReinhold added 3 commits January 8, 2026 13:32

small docs fixes

54e1ee8

simpllify storybook docs context in eval to always get components.jso…

2d99115

…n/docs.json instead of supporting custom filenames

update storybook

861b5a4

JReinhold merged commit c1fc816 into main Jan 8, 2026
11 checks passed

JReinhold deleted the support-docs-manifest-entries branch January 8, 2026 13:20

storybook-app-bot Bot mentioned this pull request Jan 8, 2026

Version Packages #121

Merged

JReinhold mentioned this pull request Jan 9, 2026

Fix manifest detection for Storybook versions lower than 10.2.0-alpha.10 #128

Merged

Conversation

JReinhold commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Breaking Changes

Uh oh!

changeset-bot Bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new Bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

JReinhold Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

JReinhold Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

valentinpalkovic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codecov Bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle Report

Affected Assets, Files, and Routes:

Assets Changed:

Assets Changed:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

JReinhold commented Jan 5, 2026 •

edited

Loading

changeset-bot Bot commented Jan 5, 2026 •

edited

Loading

pkg-pr-new Bot commented Jan 5, 2026 •

edited

Loading

codecov Bot commented Jan 5, 2026 •

edited

Loading

codecov Bot commented Jan 8, 2026 •

edited

Loading